home *** CD-ROM | disk | FTP | other *** search
/ Apple Developer Connection 1998 Fall: Game Toolkit / Disc.iso / SDKs / QuickTime Mac / AIncludes / QD3DCamera.a < prev    next >
Encoding:
Text File  |  1998-04-09  |  14.1 KB  |  465 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        QD3DCamera.a
  3. ;
  4. ;    Contains:    Generic camera routines                                             
  5. ;
  6. ;    Version:    Technology:    Quickdraw 3D 1.5.4
  7. ;                Release:    QuickTime 3.0
  8. ;
  9. ;    Copyright:    © 1995-1998 by Apple Computer, Inc., all rights reserved.
  10. ;
  11. ;    Bugs?:        Please include the the file and version information (from above) with
  12. ;                the problem description.  Developers belonging to one of the Apple
  13. ;                developer programs can submit bug reports to:
  14. ;
  15. ;                    devsupport@apple.com
  16. ;
  17. ;
  18.     IF &TYPE('__QD3DCAMERA__') = 'UNDEFINED' THEN
  19. __QD3DCAMERA__ SET 1
  20.  
  21.     IF &TYPE('__QD3D__') = 'UNDEFINED' THEN
  22.     include 'QD3D.a'
  23.     ENDIF
  24.  
  25. ; ******************************************************************************
  26. ; **                                                                             **
  27. ; **                            Data Structure Definitions                         **
  28. ; **                                                                             **
  29. ; ****************************************************************************
  30.  
  31. ; 
  32. ; *  The placement of the camera.
  33. ; 
  34.  
  35. TQ3CameraPlacement        RECORD 0
  36. cameraLocation             ds        TQ3Point3D        ; offset: $0 (0)        ;   Location point of the camera     
  37. pointOfInterest             ds        TQ3Point3D        ; offset: $C (12)        ;   Point of interest                 
  38. upVector                 ds        TQ3Vector3D        ; offset: $18 (24)        ;   "up" vector                     
  39. sizeof                     EQU *                    ; size:   $24 (36)
  40.                         ENDR
  41. ; 
  42. ; *  The range of the camera.
  43. ; 
  44.  
  45. TQ3CameraRange            RECORD 0
  46. hither                     ds        Float32            ; offset: $0 (0)        ;   Hither plane, measured from "from" towards "to"    
  47. yon                         ds        Float32            ; offset: $4 (4)        ;   Yon  plane, measured from "from" towards "to"     
  48. sizeof                     EQU *                    ; size:   $8 (8)
  49.                         ENDR
  50. ; 
  51. ; *  Viewport specification.  Origin is (-1, 1), and corresponds to the 
  52. ; *  upper left-hand corner; width and height maximum is (2.0, 2.0),
  53. ; *  corresponding to the lower left-hand corner of the window.  The
  54. ; *  TQ3Viewport specifies a part of the viewPlane that gets displayed 
  55. ; *    on the window that is to be drawn.
  56. ; *  Normally, it is set with an origin of (-1.0, 1.0), and a width and
  57. ; *  height of both 2.0, specifying that the entire window is to be
  58. ; *  drawn.  If, for example, an exposure event of the window exposed
  59. ; *  the right half of the window, you would set the origin to (0, 1),
  60. ; *  and the width and height to (1.0) and (2.0), respectively.
  61. ; *
  62. ; 
  63.  
  64. TQ3CameraViewPort        RECORD 0
  65. origin                     ds        TQ3Point2D        ; offset: $0 (0)
  66. width                     ds        Float32            ; offset: $8 (8)
  67. height                     ds        Float32            ; offset: $C (12)
  68. sizeof                     EQU *                    ; size:   $10 (16)
  69.                         ENDR
  70. TQ3CameraData            RECORD 0
  71. placement                 ds        TQ3CameraPlacement ; offset: $0 (0)
  72. range                     ds        TQ3CameraRange ; offset: $24 (36)
  73. viewPort                 ds        TQ3CameraViewPort ; offset: $2C (44)
  74. sizeof                     EQU *                    ; size:   $3C (60)
  75.                         ENDR
  76. ; 
  77. ; *  An orthographic camera.
  78. ; *
  79. ; *  The lens characteristics are set with the dimensions of a
  80. ; *  rectangular viewPort in the frame of the camera.
  81. ; 
  82.  
  83. TQ3OrthographicCameraData RECORD 0
  84. cameraData                 ds        TQ3CameraData    ; offset: $0 (0)
  85. left                     ds        Float32            ; offset: $3C (60)
  86. top                         ds        Float32            ; offset: $40 (64)
  87. right                     ds        Float32            ; offset: $44 (68)
  88. bottom                     ds        Float32            ; offset: $48 (72)
  89. sizeof                     EQU *                    ; size:   $4C (76)
  90.                         ENDR
  91. ; 
  92. ; *  A perspective camera specified in terms of an arbitrary view plane.
  93. ; *
  94. ; *  This is most useful when setting the camera to look at a particular
  95. ; *  object.  The viewPlane is set to distance from the camera to the object.
  96. ; *  The halfWidth is set to half the width of the cross section of the object,
  97. ; *  and the halfHeight equal to the halfWidth divided by the aspect ratio
  98. ; *  of the viewPort.
  99. ; * 
  100. ; *  This is the only perspective camera with specifications for off-axis
  101. ; *  viewing, which is desirable for scrolling.
  102. ; 
  103.  
  104. TQ3ViewPlaneCameraData    RECORD 0
  105. cameraData                 ds        TQ3CameraData    ; offset: $0 (0)
  106. viewPlane                 ds        Float32            ; offset: $3C (60)
  107. halfWidthAtViewPlane     ds        Float32            ; offset: $40 (64)
  108. halfHeightAtViewPlane     ds        Float32            ; offset: $44 (68)
  109. centerXOnViewPlane         ds        Float32            ; offset: $48 (72)
  110. centerYOnViewPlane         ds        Float32            ; offset: $4C (76)
  111. sizeof                     EQU *                    ; size:   $50 (80)
  112.                         ENDR
  113. ; 
  114. ; *    A view angle aspect camera is a perspective camera specified in 
  115. ; *    terms of the minimum view angle and the aspect ratio of X to Y.
  116. ; *
  117. ; 
  118.  
  119. TQ3ViewAngleAspectCameraData RECORD 0
  120. cameraData                 ds        TQ3CameraData    ; offset: $0 (0)
  121. fov                         ds        Float32            ; offset: $3C (60)
  122. aspectRatioXToY             ds        Float32            ; offset: $40 (64)
  123. sizeof                     EQU *                    ; size:   $44 (68)
  124.                         ENDR
  125. ; ******************************************************************************
  126. ; **                                                                             **
  127. ; **                            Generic Camera routines                             **
  128. ; **                                                                             **
  129. ; ****************************************************************************
  130.  
  131.  
  132. ;
  133. ; extern TQ3ObjectType Q3Camera_GetType(TQ3CameraObject camera)
  134. ;
  135.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  136.         IMPORT_CFM_FUNCTION Q3Camera_GetType
  137.     ENDIF
  138.  
  139. ;
  140. ; extern TQ3Status Q3Camera_SetData(TQ3CameraObject camera, const TQ3CameraData *cameraData)
  141. ;
  142.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  143.         IMPORT_CFM_FUNCTION Q3Camera_SetData
  144.     ENDIF
  145.  
  146. ;
  147. ; extern TQ3Status Q3Camera_GetData(TQ3CameraObject camera, TQ3CameraData *cameraData)
  148. ;
  149.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  150.         IMPORT_CFM_FUNCTION Q3Camera_GetData
  151.     ENDIF
  152.  
  153. ;
  154. ; extern TQ3Status Q3Camera_SetPlacement(TQ3CameraObject camera, const TQ3CameraPlacement *placement)
  155. ;
  156.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  157.         IMPORT_CFM_FUNCTION Q3Camera_SetPlacement
  158.     ENDIF
  159.  
  160. ;
  161. ; extern TQ3Status Q3Camera_GetPlacement(TQ3CameraObject camera, TQ3CameraPlacement *placement)
  162. ;
  163.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  164.         IMPORT_CFM_FUNCTION Q3Camera_GetPlacement
  165.     ENDIF
  166.  
  167. ;
  168. ; extern TQ3Status Q3Camera_SetRange(TQ3CameraObject camera, const TQ3CameraRange *range)
  169. ;
  170.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  171.         IMPORT_CFM_FUNCTION Q3Camera_SetRange
  172.     ENDIF
  173.  
  174. ;
  175. ; extern TQ3Status Q3Camera_GetRange(TQ3CameraObject camera, TQ3CameraRange *range)
  176. ;
  177.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  178.         IMPORT_CFM_FUNCTION Q3Camera_GetRange
  179.     ENDIF
  180.  
  181. ;
  182. ; extern TQ3Status Q3Camera_SetViewPort(TQ3CameraObject camera, const TQ3CameraViewPort *viewPort)
  183. ;
  184.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  185.         IMPORT_CFM_FUNCTION Q3Camera_SetViewPort
  186.     ENDIF
  187.  
  188. ;
  189. ; extern TQ3Status Q3Camera_GetViewPort(TQ3CameraObject camera, TQ3CameraViewPort *viewPort)
  190. ;
  191.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  192.         IMPORT_CFM_FUNCTION Q3Camera_GetViewPort
  193.     ENDIF
  194.  
  195. ;
  196. ; extern TQ3Status Q3Camera_GetWorldToView(TQ3CameraObject camera, TQ3Matrix4x4 *worldToView)
  197. ;
  198.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  199.         IMPORT_CFM_FUNCTION Q3Camera_GetWorldToView
  200.     ENDIF
  201.  
  202. ;
  203. ; extern TQ3Status Q3Camera_GetWorldToFrustum(TQ3CameraObject camera, TQ3Matrix4x4 *worldToFrustum)
  204. ;
  205.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  206.         IMPORT_CFM_FUNCTION Q3Camera_GetWorldToFrustum
  207.     ENDIF
  208.  
  209. ;
  210. ; extern TQ3Status Q3Camera_GetViewToFrustum(TQ3CameraObject camera, TQ3Matrix4x4 *viewToFrustum)
  211. ;
  212.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  213.         IMPORT_CFM_FUNCTION Q3Camera_GetViewToFrustum
  214.     ENDIF
  215.  
  216.  
  217. ; ******************************************************************************
  218. ; **                                                                             **
  219. ; **                            Specific Camera Routines                          **
  220. ; **                                                                             **
  221. ; ****************************************************************************
  222.  
  223. ; ******************************************************************************
  224. ; **                                                                             **
  225. ; **                            Orthographic Camera                                  **
  226. ; **                                                                             **
  227. ; ****************************************************************************
  228.  
  229. ;
  230. ; extern TQ3CameraObject Q3OrthographicCamera_New(const TQ3OrthographicCameraData *orthographicData)
  231. ;
  232.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  233.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_New
  234.     ENDIF
  235.  
  236. ;
  237. ; extern TQ3Status Q3OrthographicCamera_GetData(TQ3CameraObject camera, TQ3OrthographicCameraData *cameraData)
  238. ;
  239.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  240.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetData
  241.     ENDIF
  242.  
  243. ;
  244. ; extern TQ3Status Q3OrthographicCamera_SetData(TQ3CameraObject camera, const TQ3OrthographicCameraData *cameraData)
  245. ;
  246.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  247.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetData
  248.     ENDIF
  249.  
  250. ;
  251. ; extern TQ3Status Q3OrthographicCamera_SetLeft(TQ3CameraObject camera, float left)
  252. ;
  253.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  254.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetLeft
  255.     ENDIF
  256.  
  257. ;
  258. ; extern TQ3Status Q3OrthographicCamera_GetLeft(TQ3CameraObject camera, float *left)
  259. ;
  260.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  261.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetLeft
  262.     ENDIF
  263.  
  264. ;
  265. ; extern TQ3Status Q3OrthographicCamera_SetTop(TQ3CameraObject camera, float top)
  266. ;
  267.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  268.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetTop
  269.     ENDIF
  270.  
  271. ;
  272. ; extern TQ3Status Q3OrthographicCamera_GetTop(TQ3CameraObject camera, float *top)
  273. ;
  274.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  275.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetTop
  276.     ENDIF
  277.  
  278. ;
  279. ; extern TQ3Status Q3OrthographicCamera_SetRight(TQ3CameraObject camera, float right)
  280. ;
  281.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  282.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetRight
  283.     ENDIF
  284.  
  285. ;
  286. ; extern TQ3Status Q3OrthographicCamera_GetRight(TQ3CameraObject camera, float *right)
  287. ;
  288.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  289.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetRight
  290.     ENDIF
  291.  
  292. ;
  293. ; extern TQ3Status Q3OrthographicCamera_SetBottom(TQ3CameraObject camera, float bottom)
  294. ;
  295.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  296.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_SetBottom
  297.     ENDIF
  298.  
  299. ;
  300. ; extern TQ3Status Q3OrthographicCamera_GetBottom(TQ3CameraObject camera, float *bottom)
  301. ;
  302.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  303.         IMPORT_CFM_FUNCTION Q3OrthographicCamera_GetBottom
  304.     ENDIF
  305.  
  306.  
  307. ; ******************************************************************************
  308. ; **                                                                             **
  309. ; **                            ViewPlane Camera                                  **
  310. ; **                                                                             **
  311. ; ****************************************************************************
  312.  
  313. ;
  314. ; extern TQ3CameraObject Q3ViewPlaneCamera_New(const TQ3ViewPlaneCameraData *cameraData)
  315. ;
  316.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  317.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_New
  318.     ENDIF
  319.  
  320. ;
  321. ; extern TQ3Status Q3ViewPlaneCamera_GetData(TQ3CameraObject camera, TQ3ViewPlaneCameraData *cameraData)
  322. ;
  323.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  324.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetData
  325.     ENDIF
  326.  
  327. ;
  328. ; extern TQ3Status Q3ViewPlaneCamera_SetData(TQ3CameraObject camera, const TQ3ViewPlaneCameraData *cameraData)
  329. ;
  330.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  331.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetData
  332.     ENDIF
  333.  
  334. ;
  335. ; extern TQ3Status Q3ViewPlaneCamera_SetViewPlane(TQ3CameraObject camera, float viewPlane)
  336. ;
  337.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  338.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetViewPlane
  339.     ENDIF
  340.  
  341. ;
  342. ; extern TQ3Status Q3ViewPlaneCamera_GetViewPlane(TQ3CameraObject camera, float *viewPlane)
  343. ;
  344.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  345.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetViewPlane
  346.     ENDIF
  347.  
  348. ;
  349. ; extern TQ3Status Q3ViewPlaneCamera_SetHalfWidth(TQ3CameraObject camera, float halfWidthAtViewPlane)
  350. ;
  351.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  352.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetHalfWidth
  353.     ENDIF
  354.  
  355. ;
  356. ; extern TQ3Status Q3ViewPlaneCamera_GetHalfWidth(TQ3CameraObject camera, float *halfWidthAtViewPlane)
  357. ;
  358.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  359.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetHalfWidth
  360.     ENDIF
  361.  
  362. ;
  363. ; extern TQ3Status Q3ViewPlaneCamera_SetHalfHeight(TQ3CameraObject camera, float halfHeightAtViewPlane)
  364. ;
  365.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  366.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetHalfHeight
  367.     ENDIF
  368.  
  369. ;
  370. ; extern TQ3Status Q3ViewPlaneCamera_GetHalfHeight(TQ3CameraObject camera, float *halfHeightAtViewPlane)
  371. ;
  372.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  373.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetHalfHeight
  374.     ENDIF
  375.  
  376. ;
  377. ; extern TQ3Status Q3ViewPlaneCamera_SetCenterX(TQ3CameraObject camera, float centerXOnViewPlane)
  378. ;
  379.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  380.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetCenterX
  381.     ENDIF
  382.  
  383. ;
  384. ; extern TQ3Status Q3ViewPlaneCamera_GetCenterX(TQ3CameraObject camera, float *centerXOnViewPlane)
  385. ;
  386.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  387.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetCenterX
  388.     ENDIF
  389.  
  390. ;
  391. ; extern TQ3Status Q3ViewPlaneCamera_SetCenterY(TQ3CameraObject camera, float centerYOnViewPlane)
  392. ;
  393.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  394.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_SetCenterY
  395.     ENDIF
  396.  
  397. ;
  398. ; extern TQ3Status Q3ViewPlaneCamera_GetCenterY(TQ3CameraObject camera, float *centerYOnViewPlane)
  399. ;
  400.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  401.         IMPORT_CFM_FUNCTION Q3ViewPlaneCamera_GetCenterY
  402.     ENDIF
  403.  
  404.  
  405. ; ******************************************************************************
  406. ; **                                                                             **
  407. ; **                            View Angle Aspect Camera                          **
  408. ; **                                                                             **
  409. ; ****************************************************************************
  410.  
  411. ;
  412. ; extern TQ3CameraObject Q3ViewAngleAspectCamera_New(const TQ3ViewAngleAspectCameraData *cameraData)
  413. ;
  414.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  415.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_New
  416.     ENDIF
  417.  
  418. ;
  419. ; extern TQ3Status Q3ViewAngleAspectCamera_SetData(TQ3CameraObject camera, const TQ3ViewAngleAspectCameraData *cameraData)
  420. ;
  421.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  422.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_SetData
  423.     ENDIF
  424.  
  425. ;
  426. ; extern TQ3Status Q3ViewAngleAspectCamera_GetData(TQ3CameraObject camera, TQ3ViewAngleAspectCameraData *cameraData)
  427. ;
  428.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  429.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_GetData
  430.     ENDIF
  431.  
  432. ;
  433. ; extern TQ3Status Q3ViewAngleAspectCamera_SetFOV(TQ3CameraObject camera, float fov)
  434. ;
  435.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  436.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_SetFOV
  437.     ENDIF
  438.  
  439. ;
  440. ; extern TQ3Status Q3ViewAngleAspectCamera_GetFOV(TQ3CameraObject camera, float *fov)
  441. ;
  442.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  443.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_GetFOV
  444.     ENDIF
  445.  
  446. ;
  447. ; extern TQ3Status Q3ViewAngleAspectCamera_SetAspectRatio(TQ3CameraObject camera, float aspectRatioXToY)
  448. ;
  449.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  450.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_SetAspectRatio
  451.     ENDIF
  452.  
  453. ;
  454. ; extern TQ3Status Q3ViewAngleAspectCamera_GetAspectRatio(TQ3CameraObject camera, float *aspectRatioXToY)
  455. ;
  456.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  457.         IMPORT_CFM_FUNCTION Q3ViewAngleAspectCamera_GetAspectRatio
  458.     ENDIF
  459.  
  460.  
  461.  
  462.  
  463.     ENDIF ; __QD3DCAMERA__ 
  464.  
  465.